home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / dasm.doc < prev    next >
Text File  |  1995-03-31  |  3KB  |  59 lines
  1. File: DASM.DOC 
  2. Program: DASM.LIB 
  3. Author: Jim Vaccaro 301-428-6065, Gaithersburg,Md 20878 
  4. Desc: An HP48 resident Saturn disassembler (HP mnemonics) 
  5.  
  6. Requirements: J.Donnelly's ToolKit 
  7.  
  8. DASM Version 1.0 (extensive gold-REVIEW) 
  9.  
  10. WARNING: BACK UP YOUR CALCULATOR BEFORE USING THIS LIBRARY. 
  11.  
  12.  
  13. This library provides an HP-mnemonic disassembler. 
  14.  
  15. HELP tells a little about the functions SETADR take a binary address for the 
  16. disassmbly to start DIS1 disassemble 1 line.  May be used repeatedly DIS7 
  17. disassemble 7 lines.  May be used repeatedly DISASM takes starting hex address 
  18. in level 1.  Disassembles til you stop it.  Pause and print are controlled by 
  19. WAIT. and PRNT. commands 
  20.  
  21.  
  22. ATTN stops program - stack cleanup is manual 
  23.  
  24. The disassembler follows all unconditional branches in the code. 
  25.  
  26. Three global variables are created , \GaADDR , \GaADDRJ, and \GaLIN in the 
  27. current directory.  They keep track of the disassembly address and the display 
  28. line number.  You may purge them when you are done.  Since these are fixed 
  29. length objects, once they are created the source code (not rom) which is being 
  30. disassembled shouldn't move around, but try it.  To be safe, copy the object 
  31. to be examined to the top of the home directory before disassembling.  This 
  32. will also make addresses correspond to those put out by the unthreader if you 
  33. have it (see RTH.LIB).  [Note: RTH.LIB is not on this disk because the first 
  34. posted version contains some fatal bugs.  -jkh-] 
  35.  
  36. I have tried to put in most of the newer opcodes, but sorry if I missed some. 
  37.  
  38. The size of the program (13k) is mostly due to string tables stored as lists. 
  39. Presumably, arrays of strings might be much more compact but would require a 
  40. complete reorganization of the current code.  If anyone is interested, I will 
  41. upload the source. 
  42.  
  43.  
  44. DISCLAIMER: 
  45.  
  46. DASM.LIB is copyright 1991 by Jim Vaccaro, Gaithersburg Md. 
  47.  
  48. Non-commercial distrubution is allowed provided that this copyright message 
  49. and disclaimer is preserved intact. 
  50.  
  51. DASM.LIB makes use of undocumented low-level features of the HP48SX 
  52. calculator, and may or may not cause loss of data, excessive battery drainage, 
  53. and/or damage to the calculator hardware.  The Author takes no responsibility 
  54. whatsoever for any damage caused by the use of this program. 
  55.  
  56. THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED 
  57. WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
  58. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
  59.